---
title: Déployer votre site Astro sur Azion
description: Comment déployer votre site Astro sur le Web à l'aide d'Azion.
sidebar:
  label: Azion
type: deploy
logo: azion
supports: ['ssr', 'static']
i18nReady: true
---
import { Steps } from '@astrojs/starlight/components';

Vous pouvez déployer votre projet Astro sur [Azion](https://console.azion.com/), une plateforme permettant aux développeurs front-end de collaborer et de déployer des sites Web statiques (JAMstack) et SSR.

## Prérequis

Pour commencer, vous aurez besoin de :

- Un [compte Azion](https://www.azion.com/). Si vous n’en avez pas, vous pouvez créer un compte gratuit.
- Le code de votre application stocké dans un dépôt [GitHub](https://github.com/).
- la [CLI d'Azion](https://www.azion.com/en/documentation/products/azion-cli/overview/) installée pour une configuration et un déploiement de projet plus rapides.

## Comment déployer via le tableau de bord de la console Azion

Pour commencer à compiler, suivez ces étapes :

<Steps>
1. Accédez à [la console d'Azion](https://console.azion.com).
2. Sur la page d’accueil, cliquez sur le bouton **\+ Create**.
   - Cela ouvre une fenêtre modale avec les options permettant de créer de nouvelles applications et ressources.  
3. Sélectionnez l’option **Import from GitHub** et cliquez sur la carte.
   - Cette action ouvre la page des paramètres.
4. Connectez votre compte Azion à GitHub.
   - Une fenêtre contextuelle apparaîtra demandant une autorisation.
5. Choisissez le dépôt que vous souhaitez importer depuis GitHub.
6. Configurez les paramètres de compilation :
   - **Framework preset:** Sélectionnez le framework approprié (par exemple, `Astro`).  
   - **Root Directory:** Il s'agit du répertoire dans lequel se trouve votre code. Votre code doit se trouver dans le répertoire racine, et non dans un sous-répertoire. Un symbole `./` apparaît dans ce champ, indiquant qu'il s'agit d'un répertoire racine.
   - **Install Command:** la commande qui réunit vos paramètres pour la compilation en production. Les commandes de compilation ou d'installation sont exécutées via des scripts. Par exemple : `npm run build` ou `npm install` pour un paquet NPM.
7. Cliquez sur **Save and Deploy**.  
8. Surveillez le déploiement à l’aide d'**Azion Real-Time Metrics** et vérifiez que votre site est en ligne sur le périphérique.
</Steps>

## Comment déployer un site statique à l'aide du CLI Azion

<Steps>

1. **Installez la CLI d'Azion :**  
     
   - Téléchargez et installez la [CLI d'Azion](https://www.azion.com/en/documentation/products/azion-cli/overview/) pour faciliter la gestion et le déploiement.

   :::caution
   La CLI d'Azion ne prend actuellement pas en charge les environnements Windows natifs. Cependant, vous pouvez l'utiliser sous Windows via le sous-système Windows pour Linux (WSL). Suivez le [guide d’installation WSL](https://docs.microsoft.com/en-us/windows/wsl/install) pour configurer un environnement Linux sur votre machine Windows.
   :::

2. **Authentifiez l'interface CLI :**  
     
   - Exécutez la commande suivante pour authentifier votre CLI avec votre compte Azion.

   ```bash
   azion login
   ```

3. **Configurez votre application :**  
     
   - Utilisez les commandes suivantes pour initialiser et configurer votre projet :

   ```bash
   azion init
   ```  

4. **Compilez votre projet Astro :**  
     
   - Exécutez votre commande de compilation localement :

   ```bash
   azion build
   ```

5. **Déployez vos fichiers statiques :**  
     
   - Déployez vos fichiers statiques à l'aide de la CLI d'Azion :

   ```bash
   azion deploy
   ```
</Steps>

Ce guide fournit une vue d'ensemble du déploiement d'applications statiques.

## Activation du développement local à l'aide de la CLI d'Azion

Pour que l'aperçu fonctionne, vous devez exécuter la commande suivante :

```bash
azion dev
```

Une fois le serveur de développement local initialisé, l'application passe par le processus de compilation (`build`).

```bash 
Building your Edge Application. This process may take a few minutes
Running build step command:
...
```

Ensuite, lorsque la compilation est terminée, l'adresse d'accès à l'application est affichée :

```bash
[Azion Bundler] [Server] › ✔  success   Function running on port http://localhost:3000 
```

## Dépannage


### API de l'environnement d'exécution Node.js

Un projet utilisant un paquet NPM ne parvient pas à compiler avec un message d'erreur tel que `[Error] Could not resolve "XXXX. The package "XXXX" wasn't found on the file system but is built into node.`:

Cela signifie qu’un paquet ou une importation que vous utilisez n’est pas compatible avec les API de l'environnement d’exécution Azion.

Si vous importez directement une API de l'environnement d'exécution Node.js, veuillez vous référer à la [compatibilité de Node.js avec Azion](https://www.azion.com/en/documentation/products/azion-edge-runtime/compatibility/node/) pour obtenir des étapes supplémentaires sur la façon de résoudre ce problème.

Si vous importez un paquet qui importe une API de l'environnement d'exécution Node.js, vérifiez auprès de l'auteur du paquet s'il prend en charge la syntaxe d'importation `node:*`. Si ce n'est pas le cas, vous devrez peut-être trouver un paquet alternatif.
